home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 11 / Info-Mac_XI_Disc_1.cdr_ / Info-Mac XI Disc 1.cdr / Programs / Game / Board / GnuChessMac 4.0 / README next >
Encoding:
Text File  |  1997-01-15  |  6.6 KB  |  146 lines  |  [TEXT/ttxt]

  1.  
  2. GnuChessMac 4.0
  3.  
  4. December 1996.
  5. Released under the Gnu license.
  6.  
  7. Introduction
  8.  
  9. GnuChessMac 4.0 is a free chess game for the Macintosh derived from GNU Chess 4.0 available on other platforms. It is distributed under a GNU Public License and may be given away, but not sold. See the file “Copying” for details of the GNU Public LIcense.
  10.  
  11. Version 4.0 was ported by Dan Oetting (oetting@gldfs.cr.usgs.gov) assisted by Tom Gerardy (tomg@whacked.com) and Erich Oetting (erich_oetting@stortek.com).  Dan started with GNU Chess 4.0 but made many changes to the search routines, openings and transposition table. The Mac interface is based on the version 3.0 Mac port done by Airy Andre.
  12.  
  13. The version released by Dan Oetting was identified as 4.0b5. This release (4.0) is by Rolf Exner (r.exner@trl.oz.au) and adds Apple Event support, move output in standard algebraic notation, and minor tweaks to the window sizes and positions and the command keys. The Apple Event support allows GnuChessMac to be used as a chess engine by programs such as ExaChess and ExaChess Lite.
  14.  
  15. Please let us know if you find any bugs in this release. Suggestions for future enhancements are also welcome.
  16.  
  17.  
  18. Starting GnuChessMac
  19.  
  20. GnuChessMac should run on any Mac with System 7.0 or better and a megabyte of free RAM.  If more RAM is available for the transposition table, the program will play a stronger game. Change the preferred size to 4000K or more if desired.
  21.  
  22. GnuChessMac starts in Human vs Human mode, allowing you to play both sides of the game until you have set up the desired opening. To then play White, choose Human vs Mac from the Players menu; to play Black, choose Mac vs Human.
  23.  
  24.  
  25. Playing a Game
  26.  
  27. Moves are made by dragging a piece and dropping it on the desired position. Castle by moving the King two squares in the desired direction. If you attempt to make an illegal move, GnuChessMac will return the piece to its proper place.
  28.  
  29. Once White’s first move is played, it is entered in the move list. Then the Black clock in the information window is started. When Black’s move is played, the Black clock is stopped and the White clock starts.
  30.  
  31. The game will continue till a checkmate or stalemate is reached or you resign. 
  32.  
  33.  
  34. The Menus
  35.  
  36. File Menu
  37.  
  38. New Game - Reset the board and get ready for a new game in Human vs Human mode. The opening book is loaded at this time.
  39.  
  40. Open - Load a saved game to resume play.
  41.  
  42. Save - Save the current game.  Games are saved as text files in the "PGN" standard chess format.
  43.  
  44. Quit - Exits GnuChessMac.
  45.  
  46. Edit Menu
  47.  
  48. The edit functions work as expected.
  49.  
  50. The UNDO function will take back the last move by a human player.
  51.  
  52. Players Menu
  53.  
  54. The first four items in this menu select who plays what side.
  55.  
  56. Human vs. Mac - You play first as white and the computer plays black. The clocks will start when you make the first move.
  57.  
  58. Mac vs. Human - The computer plays white, you play black. This also starts the clock.
  59.  
  60. Mac vs. Mac - Turns GnuChessMac into a spectator sport.
  61.  
  62. Human vs. Human - Play a game with another human. GnuChessMac keeps track of moves and the clock. The white clock is started when this is selected. This option is set whenever a new game is started. 
  63.  
  64. The last two items control the clock setting for each side. 
  65.  
  66. White Level - Set white clock.
  67. Black Level - Set black clock.
  68.  
  69. The default clock settings are for a fairly quick game. GnuChessMac (and humans) play better if given more time. The game is not stopped if one side runs out of time.
  70.  
  71. Options Menu
  72.  
  73. Easy - If selected GnuChessMac only thinks during its turn. When not selected, GnuChessMac will look ahead while its opponent is thinking.
  74.  
  75. Reverse Display - Normally white plays from the bottom side of the display, select this to show the board with black at the bottom.
  76.  
  77. Animation - If selected, GnuChessMac moves are done slowly to make them more obvious.
  78.  
  79. Randomize - If selected, GnuChessMac will randomly pick its move from among the top candidates instead of always using the “best” move. Opening book moves are always chosen randomly regardless of how this is set.
  80.  
  81. Show Thinking - Not Implemented yet.
  82.  
  83. Show Score - Not implemented yet.
  84.  
  85. Hint - Not implemented yet.
  86.  
  87. Play Now - Force GnuChessMac to stop thinking and make its move immediately.
  88.  
  89. Windows Menu
  90.  
  91. Chess Board - Brings the chess board window to the front.
  92.  
  93. Information - Brings the information window containing the clock to the front. When a game is in progress the white or black clock will be running.
  94.  
  95. Game List - Brings the game list to the front. Moves are listed in algebraic notation.
  96.  
  97. Message - Brings the message window to the front. This is a command line interface used in testing. See the source code for how these commands work.
  98.  
  99. Console - Shows testing and play details, only present if the mouse button is held down when the program is started.
  100.  
  101.  
  102. Chess Openings
  103.  
  104. A file named “openings.pgn” should be in the same folder as GnuChessMac. When a new game is started, GnuChessMac reads this file and decides how opening moves and responses should be played. A larger version is also included, but takes too long to load on a low end Mac. To use the big openings file, just rename “openings.big” to “openings.pgn”.
  105.  
  106. Both openings files are lists of opening moves in a standard chess notation. GnuChessMac will follow the recommended moves while it can, choosing one randomly. When no listed move is found, it will do its own evaluation. The openings files can be modified with any text editor.
  107.  
  108.  
  109. Source Code
  110.  
  111. The regular GNU Chess release can be found on GNU archive sites such as prep.ai.mit.edu. Source code for this Mac version is available from Rolf Exner (r.exner@trl.oz.au).
  112.  
  113.  
  114. Scripting
  115.  
  116. GnuChessMac is scriptable using Apple’s scripting system. Here is a small script to demonstrate GnuChessMac's scripting capabilities:
  117.  
  118. tell application "GnuChessMac"
  119.     new game
  120.     move "1 e4 e5 2 Nf3 Nc6 3 Bb5 a6"
  121.     move "2… Nf6"    
  122.   search ""
  123. end tell 
  124.  
  125.  
  126. Version History
  127.  
  128. 4.0 -     Added scripting support, which allows GnuChessMac to respond to events from the
  129.              CHES event suite. Changed position and size of initial windows to line up better.
  130.              Added support for standard algebraic notation on output
  131.              Added Close Cmd-W to File menu (changed White time control shortcut to Cmd-F).
  132.              Changed Confirm Close dialog to new style.
  133.  
  134. 4.0b5 - Added Open, Save and Undo.  68k and PPC versions combined in fat binary.
  135.  
  136. 4.0b4 - Fixed crashes caused by last bug fix. Developers can no longer beat the program
  137.              so we are letting the world have a shot at it.
  138.  
  139. 4.0b3 - Fixed bug causing occasional "Bozo" moves.
  140.  
  141. 4.0b2 - Fixed recognition of checkmate and stalemate.  Program now runs on 68000
  142.              based Mac's like the Plus.
  143.  
  144. 4.0b1 - First Beta version.
  145.  
  146.